</> 技術筆記Tech Notes

在 Raspberry Pi 5 (Ubuntu 25.04) 上部署 MariaDB 及 phpMyAdmin 服務之技術指南

· 系統與硬體/樹莓派

1. 文件目的

本文件旨在提供於 Raspberry Pi 5 硬體平台及 Ubuntu Server 25.04 作業系統環境下，部署 MariaDB 資料庫系統及其網頁圖形化管理介面 phpMyAdmin 的標準作業程序。此程序涵蓋了從 MariaDB 伺服器安裝、安全性強化，到 Apache2、PHP 環境及 phpMyAdmin 的完整部署與組態設定。

2. 適用環境

本程序適用於符合以下規格的系統環境：

  • 硬體平台： Raspberry Pi 5

  • 作業系統： Ubuntu Server 25.04

  • 權限要求： 具備 sudo 指令執行權限的使用者帳戶

  • 網路連線： 有效的網際網路連線

3. MariaDB 伺服器部署程序

3.1. 系統套件更新

為確保系統環境的穩定性，應於安裝前執行系統套件的全面更新。

sudo apt update
sudo apt upgrade -y

3.2. 安裝 MariaDB 伺服器套件

使用 apt 套件管理器安裝 MariaDB 伺服器主程式。

sudo apt install mariadb-server -y

3.3. 驗證服務運行狀態

使用 systemctl 指令驗證 mariadb.service 是否已成功啟動並在背景運行。

systemctl status mariadb.service

預期回傳的 Active 狀態應為 active (running)。

4. 安裝後安全組態設定

新安裝的 MariaDB 必須執行官方提供的安全指令碼以進行基礎安全性強化。

執行以下指令以啟動互動式設定程序：

sudo apt install mariadb-client-compat
sudo mysql_secure_installation

請依據以下建議回應指令碼的提問：

  • Enter current password for root (enter for none): 按下 Enter。

  • Switch to unix_socket authentication? [Y/n]: 輸入 Y。

  • Change the root password? [Y/n]: 輸入 N。

  • Remove anonymous users? [Y/n]: 輸入 Y。

  • Disallow root login remotely? [Y/n]: 輸入 Y。

  • Remove test database and access to it? [Y/n]: 輸入 Y。

  • Reload privilege tables now? [Y/n]: 輸入 Y。

5. phpMyAdmin 部署程序

phpMyAdmin 的運行依賴於一個完整的 Web 伺服器與 PHP 環境。

5.1. 安裝 Web 伺服器及 PHP 環境

安裝 Apache2、PHP 及其運行 phpMyAdmin 所需的必要擴充套件。

sudo apt install apache2 php libapache2-mod-php php-mysql php-mbstring php-zip php-gd php-json php-curl -y

5.2. 安裝 phpMyAdmin 套件

使用 apt 安裝 phpmyadmin 套件。安裝過程中將出現數個互動式設定畫面。

sudo apt install phpmyadmin

請遵循以下步驟完成設定：

  1. Web server to reconfigure automatically: 於提示畫面中，使用空白鍵選中 apache2，使其前方出現 * 符號。隨後，按下 Tab 鍵將游標移至 <Ok>，最後按下 Enter 鍵確認。

  2. Configure database for phpmyadmin with dbconfig-common? 選擇 <Yes> 並按下 Enter 鍵，以允許安裝程式自動設定 phpMyAdmin 所需的內部資料庫。

  3. Password of the database’s administrative user: 為 phpMyAdmin 的內部使用者 phpmyadmin 設定一個高強度密碼。請務必記錄此密碼，以便未來進行問題排查。

5.3. 建立 phpMyAdmin 管理使用者

為兼顧安全性與管理便利性，建議建立一個專門用於 phpMyAdmin 管理的非 root 高權限帳戶。

  1. 登入 MariaDB 命令列介面：

    sudo mariadb

  2. 執行以下 SQL 陳述式，建立一個新管理員帳戶。請將密碼替換為高強度密碼。

CREATE USER ‘admin_user’@’%’ IDENTIFIED BY ‘a_very_strong_password’; GRANT ALL PRIVILEGES ON . TO ‘admin_user’@’%’ WITH GRANT OPTION; FLUSH PRIVILEGES; EXIT;


- `'%'` 允許此使用者從任何主機連線。在生產環境中，應將其限制為特定的管理主機 IP 位址或網段。
- `WITH GRANT OPTION` 允許此使用者在 phpMyAdmin 介面中建立及管理其他使用者權限。

# 6. 服務存取與驗證

部署完成後，可透過網頁瀏覽器存取 phpMyAdmin 管理介面。

1. 存取位址： 開啟網頁瀏覽器，導向至以下位址： `http://<您的_Raspberry_Pi_IP_位址>/phpmyadmin`
2. 登入驗證： 在登入頁面中，使用於步驟 5.3 中建立的帳戶 (`admin_user`) 及其對應的密碼進行登入。

成功登入後，即可透過圖形化介面執行各項資料庫管理作業。

# 7. 結論

完成本文件所述全部程序後，MariaDB 伺服器及其 phpMyAdmin 網頁管理介面已在目標系統上成功部署。系統已完成安全性強化，並配置了必要的管理帳戶。此平台已準備就緒，可進行後續的資料庫建立、使用者管理及其他相關的資料庫管理任務。